Usenet 1993 July/InfoMagic USENET CD-ROM July 1993.ISO/sources/misc/volume10/pcmail2/part12

Text File | 1990-01-24 | 34.3 KB | 1,108 lines

Newsgroups: comp.sources.misc
organization: Eindhoven University of Technology, The Netherlands
keywords: oops
subject: v10i044: PC-MAIL release 2, Part12/11
from: [e-mail] (Wietse Venema)
Sender: [e-mail] (Brandon S. Allbery - comp.sources.misc)

Posting-number: Volume 10, Issue 44
Submitted-by: [e-mail] (Wietse Venema)
Archive-name: pcmail2/part12

#! /bin/sh
# This is a shell archive.  Remove anything before this line, then unpack
# it by saving it into a file and typing "sh file".  To overwrite existing
# files, type "sh file -c".  You can also feed this as standard input via
# unshar, or by typing "sh <file", e.g..  If this archive is complete, you
# will see the following message at the end:
#        "End of archive 1 (of 1)."
# Contents:  FILES2 main main/cico.c main/tutorial.doc
# Wrapped by wswietse@tuewsa on Wed Jan 24 15:58:56 1990
PATH=/bin:/usr/bin:/usr/ucb ; export PATH
if test -f FILES2 -a "${1}" != "-c" ; then
  echo shar: Will not over-write existing file \"FILES2\"
else
echo shar: Extracting \"FILES2\" \(42 characters\)
sed "s/^X//" >FILES2 <<'END_OF_FILES2'
XFILES2
Xmain
Xmain/cico.c
Xmain/tutorial.doc
END_OF_FILES2
if test 42 -ne `wc -c <FILES2`; then
    echo shar: \"FILES2\" unpacked with wrong size!
fi
# end of overwriting check
fi
if test ! -d main ; then
    echo shar: Creating directory \"main\"
    mkdir main
fi
if test -f main/cico.c -a "${1}" != "-c" ; then
  echo shar: Will not over-write existing file \"main/cico.c\"
else
echo shar: Extracting \"main/cico.c\" \(5056 characters\)
sed "s/^X//" >main/cico.c <<'END_OF_main/cico.c'
X/*++
X/* NAME
X/*      cico 1
X/* SUMMARY
X/*      uucp file transfer
X/* PROJECT
X/*      pc-mail
X/* PACKAGE
X/*      cico
X/* SYNOPSIS
X/*      cico -p password [-d debuglevel]
X/* DESCRIPTION
X/*      cico is a program that connects to a real unix host
X/*      for exchange of spool files. It is a simplified
X/*    version of the unix uucico (copy-in-copy-out) program.
X/*
X/*    Options:
X/* .TP
X/*    -p password
X/*    The password that cico will use when logging in on the
X/*    unix host.
X/* .TP
X/*    -d debuglevel
X/*      Set the debugging level. It makes both the local cico
X/*      and the remote uucico more verbose. Default debugging
X/*    level is 0.
X/* FILES
X/*      cico manipulates various files in the spool directory.
X/*    See path(5) for the implementation of the message data base.
X/*
X/*      LOGFILE         transaction logging
X/*    s00000        communications parameters
X/* SEE ALSO
X/*      comm(5)        communications parameters
X/*    status(5)    error returns
X/* DIAGNOSTICS
X/*      The program terminates with a non-zero exit status if there
X/*      were problems. The error status codes can be translated
X/*    to meaningful messages (see status(5)).
X/*      More technical messages are written to the logfile.
X/* BUGS
X/*    cico only supports the functions needed for exchange of
X/*    electronic mail. Every incoming data file is treated as
X/*    if it were a mail message for the user of the pc.
X/* AUTHOR(S)
X/*      W.Z. Venema
X/*      Eindhoven University of Technology
X/*      Department of Mathematics and Computer Science
X/*      Den Dolech 2, P.O. Box 513, 5600 MB Eindhoven, The Netherlands
X/* CREATION DATE
X/*      Sat Mar 28 19:58:06 GMT+1:00 1987
X/* LAST MODIFICATION
X/*    90/01/22 13:01:17
X/* VERSION/RELEASE
X/*    2.1
X/*--*/
X
X#include <stdio.h>
X#include <setjmp.h>
X
X#include "defs.h"
X#include "logs.h"
X#include "params.h"
X#include "comm.h"
X#include "status.h"
X#include "path.h"
X
Xpublic int *systrap;                            /* panic button */
Xpublic int dflag = 0;                           /* debug flag */
X#ifdef    unix
X    public int Debug = 0;            /* UUCP compatibility */
X#endif
X
Xpublic char *progname = "cico";            /* for diagnostics etc. */
X
Xhidden void parse_args(),sanity();              /* forward declarations */
X
X/* main program - parse command line options and pull the ropes */
X
Xmain(argc,argv)
Xint argc;
Xchar **argv;
X{
X    register int status;                        /* most recent error code */
X    jmp_buf mainbuf;                            /* catch-all */
X
X    parse_args(argc,argv);                      /* process cmd arguments */
X
X    sanity();                                   /* check systems parameters */
X
X    if (setjmp(systrap = mainbuf))              /* safety net in case of */
X    exit(E_CONFUSED);                       /* too many long jumps */
X
X    xopen();                                    /* init comm. line */
X    if ((status = connect()) == 0               /* login on remote system */
X    && (status = startproto()) == 0) {          /* start comm. protocol */
X    status = switcher(MASTER);              /* use the protocol */
X    endproto();                             /* terminate the protocol */
X    }                                           /* (ignore errors) */
X    disconnect();                               /* as it says */
X    xclose();                                   /* close comm. line */
X
X    exit(status);
X    /* NOTREACHED */
X}
X
X/* parse_args - take care of command-line arguments */
X
Xhidden void parse_args(argc,argv)
Xint argc;
Xchar **argv;
X{
X    while (--argc && *++argv && **argv == '-') {
X    switch (*++*argv) {
X    case 'p':
X        if (--argc == 0)
X        usage("missing password argument");
X        password = *++argv;
X        break;
X    case 'd':
X        if (--argc == 0)
X        usage("missing debugging level argument");
X        sscanf(*++argv,"%d",&dflag);
X#ifdef    unix
X        Debug =
X#endif
X        dflag = ((dflag < 0 ? 0 : dflag) > 10 ? 10 : dflag);
X        break;
X    default:
X        usage(strcons("invalid option: -%s",*argv));
X        break;
X    }
X    }
X    if (argc > 0)
X    usage(strcons("unexpected argument: %s",*argv));
X}
X
X/* sanity - some preliminary work; mainly checks on sanity */
X
Xhidden void sanity()
X{
X    register int status;
X    register Info *ip;
X
X    if (status = pathinit())                            /* check environment */
X    exit(status);                                   /* bad environment */
X
X    if (status = open_log())                            /* check the logfile */
X    exit(status);                                   /* cannot write */
X
X    for (ip = comm = getparams(); ip->ident; ip++) {    /* check param. file */
X    if (ip->strval == 0 || ip->strval[0] == '\0')
X        exit(E_BADSETUP);                           /* incomplete setup */
X    debug(6)("%s %s\n",ip->ident,ip->strval ? ip->strval : "");
X    }
X    if (password == 0 || *password == 0)
X    usage("no password specified");                 /* no password */
X
X    strcpy(rmthost,comm[P_HOST].strval);        /* remote host name */
X}
X
X/* usage - print error message and usage string */
X
Xusage(str)
Xchar *str;
X{
X    fprintf(stderr,"%s\nusage: cico -p password [-d debuglevel]\n",str);
X    exit(2);
X}
END_OF_main/cico.c
if test 5056 -ne `wc -c <main/cico.c`; then
    echo shar: \"main/cico.c\" unpacked with wrong size!
fi
# end of overwriting check
fi
if test -f main/tutorial.doc -a "${1}" != "-c" ; then
  echo shar: Will not over-write existing file \"main/tutorial.doc\"
else
echo shar: Extracting \"main/tutorial.doc\" \(26447 characters\)
sed "s/^X//" >main/tutorial.doc <<'END_OF_main/tutorial.doc'
X
X
X
X
X
X
X
X
X
X                      PC-MAIL tutorial
X
X
X                      Wietse Z. Venema
X             Mathematics and Computing Science,
X             Eindhoven University of Technology
X                 Eindhoven, The Netherlands
X
X
X
X
X
X
X1.  What does this software do for you?
X
XThis software allows you  to  send  and  receive  electronic
Xmail.  Once the software has been configured, it can be used
Xwithout any knowledge about computer networking.
X
XThe following summarizes a few features:
X
Xo    Mail messages can be edited, printed, replied to, sent,
X     and received, from within the mail program.
X
Xo    Messages  can  be  created  with  almost  every   word-
X     processing package.
X
Xo    Almost every command can be selected by pressing a sin-
X     gle  key.  There  is a "help" facility that gives brief
X     explanations.
X
Xo    You can set up an "alias" data base to avoid the use of
X     the  usually cryptical electronic mail addresses.  This
X     facility can also be used to  implement  small  mailing
X     lists.
X
Xo    There is a facility for personalized headers and signa-
X     tures.
X
XThe mail software does not attempt to solve every problem in
Xthis  world.   It is only fair to mention the most important
Xlimitations here:
X
Xo    Any information other than pure text must be  converted
X     to  text  format before you can mail it to someone else
X     (for example, programs,  pictures  and  so  on).   For-
X     tunately, there exists a lot of software to aid in this
X     task.  The people  that  installed  the  mail  software
X     should be able to help you out.
X
Xo    Most electronic mail systems impose an upper  limit  to
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 2 -
X
X
X     the  size  of  a  mail message.  This limit varies from
X     about 60 kilobytes to about 100 kilobytes per  message.
X     You  will  have  to  break up larger messages; the mail
X     software does not do it for you.  Normally, you  should
X     not run into this limit.
X
XInstallation of the mail software is  described  in  various
Xother  documents.   The  remainder of this document gives an
Xintroduction to the use of the mail software. The  following
Xgives a summary.
X
XChapter 2, "Starting the program", describes how  to  invoke
Xthe  program,  and  how  to  leave it.  Also gives a general
Xintroduction to the command structure of the program.
X
XChapter 3, "Reading new mail", describes how to take care of
Xnew mail, and what happens once you have read a new message.
X
XChapter 4, "Creating a message", describes how to compose  a
Xmessage from scratch, and how to specify its destination.
X
XChapter  5,  "Sending  and   receiving   electronic   mail",
Xdescribes  how to exchange messages between your machine and
Xthe rest of the world.  It does not apply if your machine is
Xconnected to a "file server".
X
XChapter 6, "Alias data base", describes the use of the alias
Xdata base, and gives an example of a tiny mailing list.
X
XChapter 7, "Replying to a message", describes how to compose
Xa reply to message.
X
XChapter 8, "Mailing other files", describes how  to  distri-
Xbute files via electronic mail.
X
XChapter 9,  "Receiving  encoded  files",  describes  how  to
Xdecode files that have been encoded with e.g. the "uuencode"
Xor "btoa" programs.
X
X2.  Starting the program
X
XStarting the mail program is easy;  just  type  the  command
X"mail".   You  should  see  a screen that looks like the one
Xshown here:
X
X
X
X
X
X
X
X
X
X
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 3 -
X
X
X
XClose  File  Setup  Alias  Print  Up  Down  Enter  Help ?
X==========================================================
XCreate       Create a new message
XWork       2 Messages in preparation
XNew        0 Unread messages
XIn        30 Messages already read
XOut        7 Messages not-yet sent
XSent      20 Messages already sent
X
X
X==========================================================
XSelect a message category with cursor keys and press ENTER
Xor select one of the commands in the top line.
X
X
XThe screen is divided into three horizontal regions:
X
Xo    The top region shows the commands that can be  selected
X     by  pressing  a single key.  Some of these commands are
X     selected by pressing a function key with the same  name
X     as  the  command;  for example, the Up or Down commands
X     are selected by pressing the corresponding  arrow  key.
X     Other  commands are selected by typing the first letter
X     of that command; for example, the  H  key  selects  the
X     "Help"  command;  it  gives a brief description of what
X     the other commands do.
X
Xo    The middle region shows various categories of mail mes-
X     sages.   You might think of it as a collection of boxes
X     with letters.  For example, the "New" box is  for  mes-
X     sages  that  you haven't read yet, and the "Out" box is
X     for messages that you wrote, but that have not yet been
X     sent  away.   The  program also shows how many messages
X     there are within a message category.
X
X     A special case is the "Create" box; it is for  messages
X     you  are  going  to  write.   Think of it as a box with
X     blank sheets of paper.
X
Xo    The bottom region gives an explanation of what you  are
X     supposed  to do when you see this screen.  In this par-
X     ticular case, it tells that you can select one  of  the
X     message   categories   by  moving  the  cursor  to  the
X     appropriate line, and by pressing the "Enter"  key,  or
X     that  you can give commands by pressing the appropriate
X     key.
X
XYou can leave most screens by pressing the "C" key. In  par-
Xticular,  pressing  that  key while the program displays the
Xfirst screen is the preferred way to leave the mail program.
X
X
X
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 4 -
X
X
X3.  Reading new mail
X
XDepending on how the mail software  was  installed  on  your
Xsystem, you may have seen a message that "You have new mail"
Xwhen you started up the machine. This section describes  how
Xto deal with new mail.
X
XIn the display that was described above, move the cursor  to
Xthe  line  with "New" and press the "Enter" key. The program
Xwill present an overview of unread messages that looks  like
Xthe following one:
X
XClose  File  Setup  Alias  Print  PgUp  PgDn  Up  Down  Enter  Help ?
X=====================================================================
X   90  Dec 15 22:18  Wietse Venema "Re: how do I forward a message?"
X   63  Dec 11 23:18  Jan Kalisvaart "File server cleanup"
X    .
X    .
X    .
X-- end of display --
X
X
X=====================================================================
XSelect a message with the cursor keys and press ENTER
Xor select one of the commands in the top line.
X
X
XThe top line of the screen shows a few  more  commands  than
Xthe  screen  described  earlier.  New commands, for example,
Xare the the PgUp and PgDn commands.  They  are  useful  when
Xinformation does not fit in the middle screen region.
X
XThe middle screen region shows summaries of  mail  messages.
XEach  message  is summarized on a single line, and gives the
Xfollowing information:
X
Xo    The message sequence number (e.g. 90).   Normally,  you
X     do  not  have to remember message sequence numbers, but
X     the mail program needs them in  order  to  keep  things
X     apart.
X
Xo    The date of arrival (e.g. Dec 15 22:18).  If a  message
X     is  very old, the year will be displayed instead of the
X     hours and minutes.
X
Xo    The sender of the message (e.g. Wietse  Venema).   Usu-
X     ally,  the mail program presents a "human" name.  Every
X     now and then, however, you may see an  ugly  electronic
X     mail address.
X
Xo    The subject of the message (e.g. "Re:  how do I forward
X     a  message?").   This allows you to decide if a message
X     is urgent and has to be dealt with right  away,  or  if
X     the message can wait till later.
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 5 -
X
X
XAfter you have moved the cursor to the message you  want  to
Xread, and have pressed the "Enter" key, the program displays
Xthe selected message.  The following example shows what  the
Xscreen might look like.
X
XClose  Delete  Mail  Print  Reply  Save  Work  |  PgUp  PgDn  Up  Down  Help ?
X==============================================================================
XSubject: Re: how do I forward a message?
XOrganization: Eindhoven University of Technology, The Netherlands
XFrom: [e-mail] (Wietse Venema)
XTo: you
X
XSelect the message that you wish to forward, and press the "M" (Mail)
Xkey.  The program will ask for a destination. As usual, you can enter
Xan alias or a real address. This command mails a copy of the message;
Xit does not change or remove the message itself.
X
X                Greetings,
X                                Wietse Venema
X-- end of display --
X
X==============================================================================
X(Reading a mail message)
X
X
XAt this stage you may decide to do nothing with the message;
Xjust  hit  the  "C"  key and the program returns to the last
Xmessage-selection screen.  Now that  the  message  has  been
Xread  it  will no longer show up in an overview of the "New"
Xcategory; once a "New" message has been read it goes to  the
X"In" category, and remains there until you explicitly delete
Xit.
X
XHitting the "C" key once more brings us back to  the  begin-
Xning of the program.
X
X4.  Creating a message
X
XIn order to compose  a  message,  move  the  cursor  to  the
X"Create  a new message" line in the first screen of the mail
Xprogram and press the "Enter" key.  After a few seconds  you
Xshould see the first screens of the same word processor that
Xyou probably also use for  other  activities.   Please  note
Xthat  the  mail  program  has not terminated; as soon as you
Xexit from the word processor you will  return  back  to  the
Xmail program.
X
XIf all is well, your message should begin with a "Subject: "
Xline.  Depending on how the mail software was set up on your
Xmachine, an "empty" message may already contain one or  more
Xcustomized header lines, as well as a customized "signature"
Xat the end of the message.  The following is an "empty" mes-
Xsage  as  produced  on  my personal system (the text between
Xsquare braces is not part of the  "empty"  message;  I  just
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 6 -
X
X
Xadded it to clarify things).
X
XSubject:  [the subject of this message]
XOrganization:  Eindhoven University of Technology, The Netherlands
X
X[this is where the actual message goes]
X
X                                        Wietse Venema
X
X
XIf your "empty" message contains garbage you should  contact
Xthe people that installed the mail software on your system.
X
XThe message text that you are about to enter  will  be  only
Xpart of the message that other people will receive; the mail
Xsoftware automatically prefixes each message with  your  own
Xelectronic mail address, and the current date-.
X
XObviously, further details about the entry of  message  text
Xdepend  on  the  word-processing package that you are using.
XSuffice to say that upon exit,  the  word  processor  should
Xproduce  an "ASCII document" file; the people that installed
Xthe mail software on your machine should be able to  provide
Xmore details on this topic.
X
XUpon return from the word processor back to  the  mail  pro-
Xgram,  you  will  see  the  first  few  lines of your newly-
Xcomposed message in the middle region of the screen.   There
Xmay be "funny cookies" in your text if you forgot to produce
Xan "ASCII document"; if that is the case you had better  re-
Xenter  the  word  processor  (by  pressing  the "E" key) and
Xcorrect this mistake.  After this,  your  screen  should  be
Xsomething like:
X
X
XClose  Delete  Edit  Mail  Print  PgUp  PgDn  Up  Down  Help ?
X==============================================================
XSubject: your subject
Xoptional header lines
X
Xyour message
X-- end of display --
X
X
X==============================================================
X(Reading a message in preparation)
X
X_________________________
X- Your message will probably be prefixed  with  several
Xadditional  rude  header  lines while it passes through
Xother machines on the way to its destination. This hap-
Xpens  outside  the control of the mail software on your
Xmachine.
X
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 7 -
X
X
XWhat you see on the screen is a close approximation of  what
Xother  people  will  receive.  If this is the first time you
Xuse electronic mail you may  wish  to  use  the  "PgUp"  and
X"PgDn" keys to check things out.
X
XNormally, the next step will be to mail the message  to  its
Xdestination,  but  you  may choose any of the other commands
Xshown in the upper line of the  screen.   For  example,  you
Xcould choose the put the message "on hold"; the mail program
Xwill ask you to give a one-line description so that you  can
Xeasily  find  it  back at a later time (it will be stored in
Xthe category "Messages in preparation").
X
XIf you choose the "Mail" command, the program  will  respond
Xwith:
X
X        Press ESC to cancel. Send message to:
X        ?
X
X
XYou should enter one or more electronic  mail  addresses  or
Xaliases.   If  what you wrote was just a "test" message, you
Xmight want to mail it to yourself.  There is  nothing  crazy
Xabout  sending mail to yourself; many people do that instead
Xof littering their rooms  with  notes  on  small  pieces  of
Xpaper.   Aliases are described later on, and are more easily
Xremembered than real electronic mail addresses.  Your  input
Xshould be terminated by pressing the "Enter" key.
X
XAfter this, the program returns to the  first  screen.   The
Xmessage  you  just  "mailed"  will  temporarily  live in the
Xcategory "Not-yet sent".  If your machine is connected to  a
X"file  server",  it  will  automatically  be  moved  to  the
Xcategory "Already sent" within a short period of time.  Oth-
Xerwise, you should read the next section.
X
X5.  Sending and receiving mail
X
XThis section describes how to exchange mail messages between
Xyour  machine  and  the rest of the world. This is automati-
Xcally taken care of if your machine has a direct  connection
Xto a "file server".
X
XIf you are not connected to a "file  server",  most  of  the
Xmail-program  screens  will provide a "Network" command (for
Xexample, the first screen).  All messages that  you  produce
Xwill  stay on your machine, in the message category "Not-yet
Xsent"", until the mail software has sent them  away  through
Xthe  network.   Also, messages, having your machine as their
Xdestination, will not arrive on your machine until the  mail
Xsoftware has picked them up through the network.
X
XThe mail software may have been installed such that  it,  as
Xsoon  as  the  machine  is  turned  on,  automatically makes
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 8 -
X
X
Xcontact with the network.  In that case, you do not need  to
Xinvoke  the  "Network" command by hand.  It can, however, be
Xuseful if you are expecting urgent mail, or if you  wrote  a
Xletter that should be sent away right now.
X
XThe "Network" command is activated by pressing the "N"  key.
XThe  mail  program  will ask for a network password (the one
Xgiven to you by the people that installed the mail  software
Xon  your machine).  Transferring mail across the network may
Xtake a few minutes.  If all goes well, all messages  in  the
Xmessage  category  "Out"  will  have  moved  to the category
X"Sent"; in addition, you may have  received  new  mail  that
Xwill show up in the "New" message category.
X
X6.  Alias data base
X
XThe addresses used in electronic mail are  often  ugly,  and
Xhard  to remember.  To alleviate this problem, the mail pro-
Xgram provides an alias data base facility.  This allows  you
Xto  use  easily-remembered  names instead of mail addresses;
Xthe mail program will automatically replace aliases  by  the
Xactual  mail  addresses that you have specified in the alias
Xdata base.
X
XThe following is an example of an alias data base:
X
X        wietse  [e-mail]
X        jan     [e-mail]
X        staff   wietse jan
X
X
XAn alias data base has a very  simple  format:   each  alias
Xdefinition  consists  of  a  single line of text with two or
Xmore words.  Words may be separated  by  blanks  or  commas.
XThe  first  word  is  the alias; it will be replaced (by the
Xwords in the remainder of the  line)  if  the  mail  program
Xfinds  the alias in the destination of a mail message.  With
Xthe alias data base shown  above,  the  message  destination
X"wietse"  will  be automatically replaced by the destination
X"[e-mail]".
X
XAn interesting property is that an alias may be  defined  in
Xterms  of  other  aliases;  an  alias  may,  however, not be
Xdefined in terms of itself!  In the above example, the third
Xline  illustrates  the  definition  of  an alias in terms of
Xother aliases.  The same line also is an example of  how  to
Ximplement a small mailing list; all messages sent to "staff"
Xwill   be   sent   to   "[e-mail]"   and   to
X"[e-mail]".  Typing the word "staff" certainly is
Xeasier.
X
XThe mail program is smart enough to eliminate,  after  alias
Xreplacement,  multiple  occurrances of the same destination.
XThus, you do not have to worry about duplicate  destinations
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 9 -
X
X
Xif you combine several mailing lists into a bigger one.
X
XMost mail-program screens provide the "Alias" command.  This
Xallows  you to look at the contents of your alias data base,
Xand to invoke a word processor to make  changes.   The  word
Xprocessor  should  save  the alias data base in "ASCII docu-
Xment" format, just like ordinary mail messages.
X
XIt is worth noting that aliases can be defined in any order.
XThe above example would have worked just as well if the last
Xentry had been the first one.  Thus, you may  wish  to  keep
Xthe alias data base in sorted order.
X
XFinally, a few caveats are in order.  If an alias is defined
Xmore  than  once,  only  the  last  definition will be used.
XAlthough the mail program does not care whether an alias  is
Xdefined  in  upper case or in lower case, it is wise to keep
Xelectronic mail addresses in lower case.
X
X7.  Replying to a message
X
XReplying to a mail message is almost the same as creating  a
Xmail  message  from scratch; the main difference is that you
Xmust specify which message you are replying to.
X
XIn order to reply to a message, select it  with  the  cursor
Xkeys  and  the "Enter" key, so that the contents of the mes-
Xsage become visible on the screen.   Pressing  the  "R"  key
Xexecutes the reply command.
X
XThe program will ask you if the reply should include a  copy
Xof  the  message  being replied to.  Including a copy of the
Xoriginal message is convenient if the sender  asked  several
Xquestions; both you and the recipient of the message can see
Xwhat questions you are actually replying to.   In  order  to
Xdistinguish the text that you write from what the other per-
Xson wrote, the latter text will be prefixed with a ">" char-
Xacter at the beginning of each line.
X
XAfter you answered  the  question,  the  mail  program  will
Xinvoke  a  word processing program.  Most of what follows is
Xthe same as when you create an electronic mail message:  the
Xmail program has not terminated, but is just waiting for you
Xto finish editing; upon exit, the  word  processing  package
Xshould  produce  an "ASCII document" file; after leaving the
Xword processing program you will return to the mail program.
X
XAt this point, your screen should look like this:
X
X
X
X
X
X
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 10 -
X
X
X
XClose  Delete  Edit  Mail  Print  PgUp  PgDn  Up  Down  Help ?
X==============================================================
XSubject: Re: The subject of the original message
XOther customized header lines may go here
X
X>Text taken from the original message is prefixed
X>to distinguished it from the text that you wrote.
X
XYour text
X-- end of display --
X
X
X==============================================================
X(Reading a message in preparation)
X
X
XIn order to send the message, press the "M" key. The program
Xwill respond with:
X
X        Press ESC to cancel. Send message to:
X        ? some-mail-address
X
X
XThe mail address shown by the program  was  taken  from  the
Xoriginal message and should usually be correct.  If you wish
Xto use that address, just press the "Enter" key.  Otherwise,
Xthe address can be changed in the usual way; you can specify
Xone or more aliases or electronic mail addresses.
X
XAfter this, the message that you wrote will temporarily live
Xin  the  message category "Not-yet sent"; if your machine is
Xconnected to a "file server" the message will  automatically
Xbe  moved  to  the message category "Already sent".  If your
Xmachine is not connected to a "file server", read  the  sec-
Xtion "Sending and receiving mail".
X
X8.  Mailing other files
X
XIn addition to sending files created with your word  proces-
Xsor,  the  mail  program  provides  a facility to distribute
Xcopies of other files as well.  This feature is  of  limited
Xuse, however, since it only works well with pure text files;
Xa file that contains non-textual data, such as a program  or
Xa  picture, will have to be converted to textual form before
Xthe mail program can handle it.  The mail program can,  how-
Xever,  help  you  to find out whether a file is suitable for
Xmailing.
X
XMost screens of the mail program provide  a  "File"  command
Xthat  can  be executed by pressing the "F" key.  After a few
Xseconds the middle region of the screen should show a  list-
Xing  of the current directory.  The top region of the screen
Xlists the commands that you can execute; the  bottom  region
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 11 -
X
X
Xof the screen shows the name of the directory being listed.
X
XClose  Print  Save  PgUp  PgDn  Up  Down  Enter  Help ?
X===================================================================
X.                        <dir> Dec 28 18:10
X..                       <dir> Dec 27 16:36
Xalias.c                   3295 Dec 12 22:41
Xascf.c                    5315 Dec 23 21:16
Xcall.c                    2282 Nov 30 22:08
Xcmail.c                   3748 Dec 17 21:22
Xcreate.c                  2176 Dec 27 18:28
Xdesk.c                   12435 Dec 27 14:04
Xdeskutil.c                7180 Dec 27 15:29
X .
X .
X .
X===================================================================
XTo display a file, select it with the cursor keys, then press ENTER
X(showing directory: "/usr2/wietse/src/pc-mail/mail")
X
X
XYou can leave the "File" command at any time by pressing the
X"C" key once or twice.
X
XWith the cursor keys and the PgUP  and  PgDn  keys  you  can
X"walk"  through the directory listing.  Pressing the "Enter"
Xkey causes the program to "open" the thing  being  selected.
XIf you select a directory, the program will display the con-
Xtents of that directory; if you select a file,  the  program
Xwill display the contents of that file.
X
XIn order to mail a copy of a file, select that file with the
Xcursor  and  "Enter"  keys so that its contents are shown on
Xthe screen.  Only if you see a clean  text,  without  "funny
Xcookies",  the  file  is suitable for mailing.  Pressing the
X"M" key executes the "Mail" command.  It will ask for a des-
Xtination,  which may be one or more aliases or an electronic
Xmail addresses.  Pressing "Enter" finishes the  "Mail"  com-
Xmand.   As  usual,  the message will temporarily live in the
Xmessage category "Not-yet sent"; if  your  machine  is  con-
Xnected  to a "file server" the message will automatically be
Xmoved to the  message  category  "Already  sent".   If  your
Xmachine  is  not connected to a "file server", read the sec-
Xtion "Sending and receiving mail".
X
XIn order to leave the "File" command you may have  to  press
Xthe "C" key once or twice.
X
X9.  Receiving encoded files
X
XSometimes people send "encoded" files if they  contain  data
Xthat  cannot be sent directly as an electronic mail message.
XEncoded files must be processed by a "decoding"  program  in
Xorder to restore the original data.
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 12 -
X
X
XThere exist various encoding methods.  Usually,  the  sender
Xwill  provide  some  information  about  the encoding method
Xused.  In case of doubt, you will have to consult a  techni-
Xcal person.
X
XIf a message was encoded with the "uuencode" program it usu-
Xally looks like
X
Xbegin 644 tutorial.ms
XM7"(@9F]R;6%T('=I=&@@=&AE(&US(&UA8W)O(&QI8G)A<GD*+E1,"E!#+4U!;
XM24P@='5T;W)I86P*+D%5"E=I971S92!:+B!696YE;6$*36%T:&5M871I8W,@P
XM86YD($-O;7!U=&EN9R!38VEE;F-E+`I%:6YD:&]V96X@56YI=F5R<VET>2!OJ
X .
X .
X .
X
X
XIn order to restore the original file,  select  the  message
Xsuch  that  its contents appear on the screen, and press the
X"|" key.  The program will ask for the name of a command:
X
X    Press ESC to cancel. Filter through command:
X    ?
X
X
XAt this point, specify the "uudecode" command and press  the
X"ENTER" key.
X
X    Press ESC to cancel. Filter through command:
X    ? uudecode
X
X
XThis produces, in the current working directory,  a  decoded
Xfile  with the same name as shown in the "begin" line in the
Xmessage (in this  particular  example,  the  name  would  be
X"tutorial.ms").
X
XAnother popular encoding program is "btoa". If that  program
Xhas been used, the message looks somewhat like:
X
Xxbtoa Begin
X>Tt;&DfT]'F<GdAFD)e=BOr<'F!,=.@rcK1Ch[@!@<-W#/lYLO:dZg/5tO`m
XqQFE;"9=tUpuASu'r@1#_;FD,6&@<?3nF!+n/A0=6XD/aW>Bl7Q+;e'NQDI[
XJ=9*EcYr:Gp%$;+B2o^BPqa)DeF>&7;6XMBQ&'*DCco0BOr;]ATVTsEbo0%A
X .
X .
X .
X
X
XIn order to restore the original file,  select  the  message
Xsuch  that  its contents appear on the screen, and press the
X"|" key.  The program will ask for the name of a command:
X
X
X
X
X
X                      January 24, 1990
X
X
X
X
X
X                           - 13 -
X
X
X
X    Press ESC to cancel. Filter through command:
X    ?
X
X
XAt this point, specify the "atob" command and a  file  name,
Xand press the "ENTER" key.  For example,
X
X    Press ESC to cancel. Filter through command:
X    ? atob >abc.def
X
X
XThe ">" is needed or you will get the decoded data  on  your
Xscreen.   If  all  goes  well, you should now have a decoded
Xfile in your current working directory (in this example, the
Xname of the file would be "abc.def").
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X                      January 24, 1990
X
X
END_OF_main/tutorial.doc
if test 26447 -ne `wc -c <main/tutorial.doc`; then
    echo shar: \"main/tutorial.doc\" unpacked with wrong size!
fi
# end of overwriting check
fi
echo shar: End of archive 1 \(of 1\).
cp /dev/null ark1isdone
MISSING=""
for I in 1 ; do
    if test ! -f ark${I}isdone ; then
    MISSING="${MISSING} ${I}"
    fi
done
if test "${MISSING}" = "" ; then
    echo You have unpacked all 1 archives.
    rm -f ark[1-9]isdone
else
    echo You still need to unpack the following archives:
    echo "        " ${MISSING}
fi
##  End of shell archive.
exit 0